home *** CD-ROM | disk | FTP | other *** search
/ CU Amiga Super CD-ROM 23 / CU Amiga - Super CD-ROM 23 (June 1998).iso / CUCD / Online / TaylorUUCP / man / uurate.doc < prev   
Encoding:
Text File  |  1998-04-03  |  10.0 KB  |  265 lines
  1.  
  2.  
  3.  
  4. uurate(1)                                               uurate(1)
  5.  
  6.  
  7. NNAAMMEE
  8.        uurate - Report Taylor UUCP statistics
  9.  
  10. SSYYNNOOPPSSIISS
  11.        uuuurraattee [ --aaccddeeffhhiippqqttvvxx ] [ --ss _h_o_s_t  ] [ _-_I _c_o_n_f_i_g  ][ _l_o_g_-
  12.        _f_i_l_e_._._. ]
  13.  
  14.        or simply,
  15.  
  16.        uuuurraattee
  17.  
  18.        for a traffic summary report.
  19.  
  20. DDEESSCCRRIIPPTTIIOONN
  21.        The _u_u_r_a_t_e command provides tabular summary reports on the
  22.        operation  of  the  Taylor UUCP system. Data is taken from
  23.        the currently active log files, standard input, or from  a
  24.        list  of log files given on the command line. Output is in
  25.        the form of tabular reports summarizing call, file  trans-
  26.        fer, and command execution (_u_u_x_q_t) activity.
  27.  
  28.        The  log  and  stats  files given to _u_u_r_a_t_e must be in the
  29.        ``Taylor'' or ``V2'' format. Also, note that call and file
  30.        transfer  activities  are  logged in separate files, nomi-
  31.        nally called _L_o_g and _S_t_a_t_s_, respectively. For  reports  to
  32.        be  meaningful, the _L_o_g and _S_t_a_t_s files should be given to
  33.        _u_u_r_a_t_e together, and cover the same time period.
  34.  
  35.        If neither the --ii or --II option nor any _l_o_g_f_i_l_e options are
  36.        given,  _u_u_r_a_t_e  defaults to taking its input from the cur-
  37.        rent Taylor _L_o_g and _S_t_a_t_s files. The names are  either  as
  38.        defined  at  compilation  time, in case there is no config
  39.        file, or taken from the arguments of the keywords  _l_o_g_f_i_l_e
  40.        and _s_t_a_t_f_i_l_e when encountered in the config file.  This is
  41.        the normal mode of operation.
  42.  
  43.        The reporting options  described  below  can  be  used  to
  44.        select  the  set  of  reports  desired.  If no options are
  45.        given, a summary report is displayed. If there is no rele-
  46.        vant  data for a particular report or host, that report or
  47.        host will be suppressed.
  48.  
  49. OOPPTTIIOONNSS
  50.        The following options may be given to _u_u_r_a_t_e_:
  51.  
  52.        --aa   All reports. Identical to --ccffeexxpp..
  53.  
  54.        --cc   Report on call statistics. Requires data from  a  _L_o_g
  55.             file.
  56.  
  57.        --dd   will print the default config file to be used.
  58.  
  59.        --ee   Report  on efficiency (total connect time versus time
  60.             spent transferring files). Requires data from both  a
  61.  
  62.  
  63.  
  64.                                                                 1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. uurate(1)                                               uurate(1)
  71.  
  72.  
  73.             _L_o_g  and  a  _S_t_a_t_s  file, and they must span the same
  74.             time period.
  75.  
  76.        --ff   Report on file  transfer  statistics.  Requires  data
  77.             from a _S_t_a_t_s file.
  78.  
  79.        --hh   will print a short help information.
  80.  
  81.        --ii   tells  uurate  to  read  any logfile information from
  82.             standard input.
  83.  
  84.        --pp   report on protocol errors and packets sent/received
  85.  
  86.        --qq   do not print the Environment information,
  87.  
  88.        --tt   All reports. Identical to --ccffeexxpp..  plus  the  CCoommppaacctt
  89.             ssuummmmaarryy..
  90.  
  91.        --vv   will print the version id string
  92.  
  93.        --xx   Report  on  remote  execution requests (e.g., _r_m_a_i_l).
  94.             Requires data from a _L_o_g file.
  95.  
  96.        --ss _h_o_s_t
  97.             Restrict report output to _h_o_s_t_.
  98.  
  99.        --II _c_o_n_f_i_g _f_i_l_e
  100.             an alternate  config  file  may  be  passed  by  this
  101.             option.
  102.  
  103. DDEESSCCRRIIPPTTIIOONN OOFF RREEPPOORRTTSS
  104.        There are four reports available: the call, file transfer,
  105.        efficiency, and remote  execution  reports.  Each  may  be
  106.        selected  by  a  command  line  option. All reports may be
  107.        selected via the options --aa or --tt..  If no report selection
  108.        options  are given, _u_u_r_a_t_e displays a compact traffic sum-
  109.        mary report (see below).
  110.  
  111.    SSuummmmaarryy rreeppoorrtt
  112.        If no report options are given, _u_u_r_a_t_e displays a  traffic
  113.        summary  report. This is particularly useful in daily _c_r_o_n
  114.        jobs which report on errors and the like. Traffic  statis-
  115.        tics  for each active system is reported on a single line.
  116.        If more than one system was active,  a  'totals'  line  is
  117.        included at the end of the report.
  118.  
  119.    PPrroottooccooll ppaacckkeett rreeppoorrtt
  120.        The protocol report gives statistics on min/max packet and
  121.        window sizes used during transmission. Further on data  is
  122.        collected  for  packets transferred. The data is collected
  123.        for each host/protocol type.   The  fields  are  described
  124.        below:
  125.  
  126.           ssiittee      UUCP node name of neighbor host system,
  127.  
  128.  
  129.  
  130.                                                                 2
  131.  
  132.  
  133.  
  134.  
  135.  
  136. uurate(1)                                               uurate(1)
  137.  
  138.  
  139.           ttyypp       Type of protocol used
  140.           MMiinn       minimum packet/window size
  141.           MMaaxx       maximum packet/window size
  142.           sseenntt      packets sent
  143.           rreesseenntt    packets resent
  144.           rreecceeiivveedd  packets received
  145.  
  146.    PPrroottooccooll eerrrroorr rreeppoorrtt
  147.        The protocol report gives statistics on packet errors dur-
  148.        ing transmission. The data is collected for each host/pro-
  149.        tocol type.  The fields are described below:
  150.  
  151.           ssiittee           UUCP node name of neighbor host system,
  152.           ttyypp            Type of protocol used
  153.           hheeaaddeerr         number of errors in header
  154.           cchheecckkssuumm       number of checksum errors
  155.           oorrddeerr          number of order errors
  156.           rreesseenntt         number packets resent
  157.           rreemm--rreejjeecctt     packets that the remote site rejected
  158.  
  159.    CCaallll rreeppoorrtt
  160.        The  call  report gives statistics on inbound and outbound
  161.        calls  for  each  active  host  system.  The  fields   are
  162.        described below:
  163.  
  164.           ssiittee      UUCP node name of neighbor host system,
  165.           ssuucccc..     Successful calls attempted to/by that system,
  166.           ffaaiilleedd    Failed calls to/by that system,
  167.           ttoottaall     Total calls to/by that system,
  168.           ttiimmee      Collected connect time (hh:mm:ss) for all calls,
  169.  
  170.    FFiillee ttrraannssffeerr rreeppoorrttss
  171.        The  file  transfer reports give statistics on inbound and
  172.        outbound file transfers (regardless of which end initiated
  173.        the  transfer)  for each active host system. There are two
  174.        reports, one for files sent to the remote system  and  one
  175.        for  files  received from the remote system. The fields in
  176.        each report are described below:
  177.  
  178.           ssiittee        UUCP node name of neighbor host system
  179.           ffiilleess       Number of files transferred
  180.           BByytteess//11000000  Total size of files transferred given in thousands
  181.           xxffrr ttiimmee    Total time (hh:mm:ss) spent on transfer the files,
  182.           BB//sseecc       Average transfer rate (bytes/sec).
  183.  
  184.    EEffffiicciieennccyy rreeppoorrtt
  185.        The efficiency report describes  the  utilization  of  the
  186.        links  to  each  active remote system, giving the ratio of
  187.        total connect time to the time spent actually transferring
  188.        files.  The fields are described below:
  189.  
  190.           ssiittee       UUCP node name of neighbor host system
  191.           ccoonnnneecctteedd  Total connect time for that system (turn-around)
  192.           xxffrr ttiimmee   Total file transfer time for that system
  193.  
  194.  
  195.  
  196.                                                                 3
  197.  
  198.  
  199.  
  200.  
  201.  
  202. uurate(1)                                               uurate(1)
  203.  
  204.  
  205.           oovveerrhheeaadd   Connect time not used to transfer files,
  206.           eeffff.. %%     Ratio of connect time to transfer time (xfer*100/conn)
  207.  
  208.    CCoommmmaanndd eexxeeccuuttiioonnss rreeppoorrtt
  209.        The  remote  execution report describes remotely requested
  210.        command executions from  each  active  host  system,  like
  211.        _r_m_a_i_l and _r_n_e_w_s.  Up to eight command names are displayed.
  212.        If there are more, the rest will be  put  together  in  an
  213.        `Misc.' column.  The fields are described below:
  214.  
  215.           ssiittee        UUCP node name of neighbor host system,
  216.           ((ccoommmmaanndd))   Number of requests of this command,
  217.           MMiisscc..       Number of other requests, if more than eight.
  218.  
  219.    FFIILLEESS
  220.        The file names below may be changed at compilation time or
  221.        by the configuration file, so these  are  only  approxima-
  222.        tions.
  223.           _/_u_s_r_/_s_p_o_o_l_/_u_u_c_p_/_L_o_g   V2/Taylor format call/execution log,
  224.           _/_u_s_r_/_s_p_o_o_l_/_u_u_c_p_/_S_t_a_t_s V2/Taylor format file transfer log.
  225.  
  226.    SSEEEE AALLSSOO
  227.        _u_u_c_i_c_o(8)
  228.  
  229.    BBUUGGSS
  230.        Does  not understand other than V2/TAYLOR logging formats.
  231.        Anyone care to volunteer to add the not mentioned?
  232.  
  233.        Scanning the arguments of logfile and statfile keywords in
  234.        config should handle lines continued with the backslash as
  235.        well.
  236.  
  237.        The ffaaiillffmm field in the call statistics  table  is  always
  238.        zero, unless something really serious happens, e.g. uucico
  239.        got SIGQUIT or the whole system crashed.
  240.  
  241.    AAUUTTHHOORR
  242.        Robert B. Denny (denny@alisa.com).
  243.        Loosely based on the DECUS UUCP  program  _u_u_r_a_t_e  by  Mark
  244.        Pizzolato.
  245.        Modified by Stephan Niemz (stephan@sunlab.ka.sub.org).
  246.        Modified by Klaus Dahlenburg (kdburg@incoahe.hanse.de).
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.                                                                 4
  263.  
  264.  
  265.